Node / meshtastic / Meshtastic-Android / files / androidApp / src / google / kotlin / org / meshtastic / app / map / component / NodeClusterMarkers.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.app.map.component

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.ui.graphics.Color

Tff7b72import T7ee787androidx.compose.ui.platform.LocalConfiguration

Tff7b72import T7ee787com.google.maps.android.clustering.Cluster

Tff7b72import T7ee787com.google.maps.android.clustering.algo.NonHierarchicalDistanceBasedAlgorithm

Tff7b72import T7ee787com.google.maps.android.clustering.algo.NonHierarchicalViewBasedAlgorithm

Tff7b72import T7ee787com.google.maps.android.clustering.algo.ScreenBasedAlgorithmAdapter

Tff7b72import T7ee787com.google.maps.android.clustering.view.DefaultClusterRenderer

Tff7b72import T7ee787com.google.maps.android.compose.Circle

Tff7b72import T7ee787com.google.maps.android.compose.MapsComposeExperimentalApi

Tff7b72import T7ee787com.google.maps.android.compose.clustering.Clustering

Tff7b72import T7ee787com.google.maps.android.compose.clustering.ClusteringMarkerProperties

Tff7b72import T7ee787org.meshtastic.app.map.model.NodeClusterItem

Tff7b72import T7ee787org.meshtastic.feature.map.BaseMapViewModel

Tff7b72private Tff7b72const Tff7b72val Te6edf3MIN_CLUSTER_SIZE Tff7b72= T79c0ff1T79c0ff0

T8b949e/**

* Threshold for switching to [NonHierarchicalViewBasedAlgorithm], matching that class's own KDoc describing itself as

* being for "large numbers of items (>1000 markers)".

*/

Tff7b72private Tff7b72const Tff7b72val Te6edf3VIEW_BASED_ALGORITHM_NODE_THRESHOLD Tff7b72= T79c0ff1T79c0ff0T79c0ff0T79c0ff0

T8b949e/**

* Renders node markers with clustering via the library's [Clustering] composable.

*

* Each unclustered node is composed as a [PulsingNodeChip] (`clusterItemContent`), with its z-index forwarded through

* [ClusteringMarkerProperties]; cluster bubbles keep the library's default rendering. Native info windows

* (title/snippet from [NodeClusterItem]) and click interactions are handled by the library renderer, and precision

* circles are drawn for the currently-unclustered items via `clusterItemDecoration`.

*

* Requires maps-compose >= 8.4.0: earlier versions composed cluster items into a detached `ComposeView` that carried no

* lifecycle/saved-state owners, crashing under the Navigation 3 hierarchy (fixed upstream in

* googlemaps/android-maps-compose#930, which this file previously worked around with a custom [DefaultClusterRenderer]

* assigning pre-baked bitmaps).

*

* Below [VIEW_BASED_ALGORITHM_NODE_THRESHOLD] nodes, clusters with the default `NonHierarchicalDistanceBasedAlgorithm`

* (pans smoother, and clustering the whole node set is cheap at this scale). Above it, switches to

* [NonHierarchicalViewBasedAlgorithm] to avoid a spread-out mesh returning nearly every node as its own unclustered

* result at high zoom (#4544) - at the cost of its zero-margin, camera-idle-only viewport bounds popping markers in

* abruptly while panning.

*/

Tf0883e@OptInTb4b4b4(Te6edf3MapsComposeExperimentalApiTff7b72::Te6edf3classTb4b4b4)

Tf0883e@Composable

Tff7b72fun Td2a8ffNodeClusterMarkersTb4b4b4(

Te6edf3nodeClusterItemsTb4b4b4: Te6edf3ListTff7b72<Te6edf3NodeClusterItemTff7b72>Tb4b4b4,

Te6edf3mapFilterStateTb4b4b4: Te6edf3BaseMapViewModelTb4b4b4.Te6edf3MapFilterStateTb4b4b4,

Te6edf3navigateToNodeDetailsTb4b4b4: Tb4b4b4(Tffa657IntTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,

Te6edf3onClusterClickTb4b4b4: Tb4b4b4(Te6edf3ClusterTff7b72<Te6edf3NodeClusterItemTff7b72>Tb4b4b4) Tff7b72-Tff7b72> Tffa657BooleanTb4b4b4,

Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3configuration Tff7b72= Te6edf3LocalConfigurationTb4b4b4.Te6edf3current

Te6edf3ClusteringTb4b4b4(

Te6edf3items Tff7b72= Te6edf3nodeClusterItemsTb4b4b4,

Te6edf3onClusterClick Tff7b72= Te6edf3onClusterClickTb4b4b4,

Te6edf3onClusterItemInfoWindowClick Tff7b72= Tb4b4b4{ Te6edf3item Tff7b72-Tff7b72> Te6edf3navigateToNodeDetailsTb4b4b4(Te6edf3itemTb4b4b4.Te6edf3nodeTb4b4b4.Te6edf3numTb4b4b4) Tb4b4b4}Tb4b4b4,

Te6edf3clusterItemContent Tff7b72= Tb4b4b4{ Te6edf3item Tff7b72-Tff7b72>

Te6edf3ClusteringMarkerPropertiesTb4b4b4(Te6edf3zIndex Tff7b72= Te6edf3itemTb4b4b4.Te6edf3zIndexTb4b4b4)

Te6edf3PulsingNodeChipTb4b4b4(Te6edf3node Tff7b72= Te6edf3itemTb4b4b4.Te6edf3nodeTb4b4b4)

Tb4b4b4}Tb4b4b4,

Te6edf3clusterItemDecoration Tff7b72= Tb4b4b4{ Te6edf3item Tff7b72-Tff7b72>

Tff7b72if Tb4b4b4(Te6edf3mapFilterStateTb4b4b4.Te6edf3showPrecisionCircleTb4b4b4) Tb4b4b4{

Te6edf3itemTb4b4b4.Te6edf3getPrecisionMetersTb4b4b4(Tb4b4b4)Tff7b72?.Te6edf3let Tb4b4b4{ Te6edf3precisionMeters Tff7b72-Tff7b72>

Tff7b72if Tb4b4b4(Te6edf3precisionMeters Tff7b72> T79c0ff0Tb4b4b4) Tb4b4b4{

Te6edf3CircleTb4b4b4(

Te6edf3center Tff7b72= Te6edf3itemTb4b4b4.Te6edf3positionTb4b4b4,

Te6edf3radius Tff7b72= Te6edf3precisionMetersTb4b4b4,

Te6edf3fillColor Tff7b72= Te6edf3ColorTb4b4b4(Te6edf3itemTb4b4b4.Te6edf3nodeTb4b4b4.Te6edf3colorsTb4b4b4.Te6edf3secondTb4b4b4)Tb4b4b4.Te6edf3copyTb4b4b4(Te6edf3alpha Tff7b72= T79c0ff0.2fTb4b4b4)Tb4b4b4,

Te6edf3strokeColor Tff7b72= Te6edf3ColorTb4b4b4(Te6edf3itemTb4b4b4.Te6edf3nodeTb4b4b4.Te6edf3colorsTb4b4b4.Te6edf3secondTb4b4b4)Tb4b4b4,

Te6edf3strokeWidth Tff7b72= T79c0ff2fTb4b4b4,

Te6edf3zIndex Tff7b72= T79c0ff0fTb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}Tb4b4b4,

Te6edf3onClusterManager Tff7b72= Tb4b4b4{ Te6edf3clusterManager Tff7b72-Tff7b72>

T8b949e// The library renderer extends DefaultClusterRenderer; raise its clustering threshold once.

Tff7b72val Te6edf3renderer Tff7b72= Te6edf3clusterManagerTb4b4b4.Te6edf3renderer Tff7b72as? Te6edf3DefaultClusterRendererTff7b72<Tff7b72*Tff7b72>

Tff7b72if Tb4b4b4(Te6edf3renderer Tff7b72!Tff7b72= Tff7b72null Tff7b72&Tff7b72& Te6edf3rendererTb4b4b4.Te6edf3minClusterSize Tff7b72!Tff7b72= Te6edf3MIN_CLUSTER_SIZETb4b4b4) Tb4b4b4{

Te6edf3rendererTb4b4b4.Te6edf3minClusterSize Tff7b72= Te6edf3MIN_CLUSTER_SIZE

Te6edf3clusterManagerTb4b4b4.Te6edf3clusterTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e// Only swap on a threshold crossing; otherwise just resize in place - replacing re-migrates every item.

Tff7b72val Te6edf3algorithm Tff7b72= Te6edf3clusterManagerTb4b4b4.Te6edf3algorithm

Tff7b72val Te6edf3needsViewBasedAlgorithm Tff7b72= Te6edf3nodeClusterItemsTb4b4b4.Te6edf3size Tff7b72> Te6edf3VIEW_BASED_ALGORITHM_NODE_THRESHOLD

Tff7b72when Tb4b4b4{

Te6edf3needsViewBasedAlgorithm Tff7b72&Tff7b72& Te6edf3algorithm Tff7b72is Te6edf3NonHierarchicalViewBasedAlgorithmTff7b72<Tff7b72*Tff7b72> Tff7b72-Tff7b72>

Te6edf3algorithmTb4b4b4.Te6edf3updateViewSizeTb4b4b4(Te6edf3configurationTb4b4b4.Te6edf3screenWidthDpTb4b4b4, Te6edf3configurationTb4b4b4.Te6edf3screenHeightDpTb4b4b4)

Te6edf3needsViewBasedAlgorithm Tff7b72-Tff7b72>

Te6edf3clusterManagerTb4b4b4.Te6edf3setAlgorithmTb4b4b4(

Te6edf3NonHierarchicalViewBasedAlgorithmTb4b4b4(Te6edf3configurationTb4b4b4.Te6edf3screenWidthDpTb4b4b4, Te6edf3configurationTb4b4b4.Te6edf3screenHeightDpTb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3algorithm Tff7b72is Te6edf3NonHierarchicalViewBasedAlgorithmTff7b72<Tff7b72*Tff7b72> Tff7b72-Tff7b72>

T8b949e// Kotlin won't resolve setAlgorithm's Algorithm<T> overload for a plain

T8b949e// NonHierarchicalDistanceBasedAlgorithm; wrap it to force the ScreenBasedAlgorithm<T> overload.

Te6edf3clusterManagerTb4b4b4.Te6edf3setAlgorithmTb4b4b4(

Te6edf3ScreenBasedAlgorithmAdapterTb4b4b4(Te6edf3NonHierarchicalDistanceBasedAlgorithmTff7b72<Te6edf3NodeClusterItemTff7b72>Tb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tb4b4b4}